Skip to main content
请求

curl --location 'https://openapi.gs-robot.com/openapi/v3/schedules/plans/simple/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
"dayOfMonth": 29,
"month": 8,
"operationType": 2,
"planStartTime": "11:00",
"planStopTime": "12:00",
"planUuid": "00000000-0000-4000-8000-000000000001",
"robotSn": "TEST00-0000-000-B088",
"taskName": "工作日清洁排班(已调整)",
"year": 2026
}'

版本限制:本接口仅支持 AIO1.6 及以上软件版本。

注意事项

  • 本接口支持部分更新。除 robotSnplanUuidoperationTypeyearmonthdayOfMonth 外,只需传需要修改的字段;未传的业务字段保留原值,不建议传 null
  • yearmonthdayOfMonth 仅用于定位目标日期。operationType=1 仅修改该日期的排班,operationType=2 修改该日期及未来所有排班。
  • mapResourceList 一旦传入会整体替换原资源列表;每项必须包含 mapIdmapResourceIdmapResourceType,并使用 /openapi/v3/maps/schedule-resources/list 的实际返回值。
  • workMode 一旦传入,mode 必填,所有字段必须参考资源查询接口的实际 workModes。若仅凭 mode 不能唯一匹配,请补充 subTypetypestrength
  • taskAdvanceConfig 按子字段合并,未传的子字段保留原值。
  • 写接口的 planExecuteType 使用整数 1(定时任务)或 2(定量任务)。定量任务可用 "planStopTime": "" 清除原结束时间;定时任务的结束时间不能为空。
  • 时间格式为 HH:mm(24 小时制)。非空结束时间必须晚于开始时间,不支持跨午夜。
输出

{
"code": 0,
"data": {},
"msg": "success"
}